home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / slots16.zip / SLOTS.DOC < prev    next >
Text File  |  1993-04-05  |  11KB  |  250 lines
  1.          ┌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄┐
  2.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  3.  ────────┤▌ G  A  M  E  K  E  E  P  E  R    D  O  O  R  W  A  R  E ▐├────────
  4.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  5.          ├▌▒▒▒▒▒▒▒▒▒  Quality BBS Door Software for Less!  ▒▒▒▒▒▒▒▒▐┤
  6.          ├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
  7.          └▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀┘
  8.  
  9.                           J A C K P O T    S L O T S
  10.                           ~~~~~~~~~~~~~    ~~~~~~~~~
  11.                                  Version 1.6
  12.  
  13.                      Copyright (c) Steve Sharpe 1992,1993
  14.  
  15. SYSTEM REQUIREMENTS
  16. ~~~~~~~~~~~~~~~~~~~
  17. 1.  Any BBS capable of producing the following DOOR.SYS drop files:
  18.  
  19.    *  Original "GAP standard" DOOR.SYS (31 line version)
  20.         - for example, Spitfire BBSs use this one!
  21.  
  22.    *  New (currently 52 line) version DOOR.SYS promoted by Raymond Clements
  23.         - for example, PCBoard BBSs use this one!
  24.  
  25. 2.  Jackpot Slots requires ANSI graphics!
  26.  
  27. SYSTEM OPTIONS
  28. ~~~~~~~~~~~~~~
  29. Jackpot Slots supports the use of FOSSIL drivers and non-standard port
  30. addresses.  Refer to the INSTALLATION instructions for more information.
  31.  
  32. FILES CONTAINED IN SLOTS16.ZIP
  33. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34.      SLOTS16.EXE   <-- The main program
  35.      SLOTS.DOC     <-- The file you are reading!
  36.      GAME.CFG      <-- The game configuration file
  37.      REVISION.DOC  <-- Revision notes
  38.      DOORWARE.DOC  <-- Gamekeeper Doorware
  39.  
  40. FILES CREATED BY SLOTS16.EXE
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42.      USER.DAT        <-- User data files.
  43.      JACKPOT.WIN     <-- File containing jackpot winners.
  44.  
  45. OVERVIEW
  46. ~~~~~~~~
  47.       JACKPOT SLOTS is a fairly authentic re-creation of a gambling casino
  48. progressive $1 slot machine.  The rules are simple...just deposit from 1 - 7
  49. dollars (if you have that many left!) into the machine.  Each dollar lights a
  50. payoff line.  As in real slots, you only win on the payoff lines that are lit.
  51. If you deposit more than 7 coins, the machine will return the excess coins.
  52. When ready, just pull on the handle and watch the wheels spin!  If you win,
  53. the payoff amount will be displayed and your winnings will fall into the
  54. machine tray.  Each player begins the game with $50 dollars in their bankroll.
  55. From then on, the game keeps track of your bankroll and saves the amount for
  56. use during future plays.  If you lose it all, your bankroll will reset to $50
  57. dollars.  The game also keeps track of the number of times you go broke!  You
  58. become a jackpot winner by getting 5 BARS in a row.  You can view jackpot
  59. winners (registered version only) or other players' current bankrolls from the
  60. menu.  Players can toggle the coin drop function on and off from a game
  61. options menu.  They can also select ANSI color or monochrome displays from the
  62. same menu.
  63.  
  64.       All payoffs are made by matching the slot machine windows in left to
  65. right order.  The following table reflects the payoff amounts for each
  66. symbol group:
  67.  
  68. CHERRIES          CIRCLES           DOLLARS           BARS
  69. ~~~~~~~~          ~~~~~~~           ~~~~~~~           ~~~~
  70. 1 - $2            1 - $0            1 - $0            1 - $0
  71. 2 - $4            2 - $0            2 - $0            2 - $0
  72. 3 - $6            3 - $10           3 - $25           3 - $250
  73. 4 - $8            4 - $25           4 - $50           4 - $500
  74. 5 - $10           5 - $50           5 - $100          5 - $1000 (JACKPOT!)
  75.  
  76. INSTALLATION
  77. ~~~~~~~~~~~~
  78. Jackpot Slots is easy to install.  Simply follow these steps:
  79.  
  80. 1.  'Unzip' the file SLOTS16.ZIP into the directory of your choice.  All files
  81. must remain in the same directory.
  82.  
  83. 2.  Edit the GAME.CFG configuration file according to the CONFIGURATION FILE
  84. section of these instructions using your favorite word processor.  Ensure you
  85. save them as ASCII text files.
  86.  
  87. 3.  Create or edit the batch file your BBS will use to activate the door.
  88. The main door program name is SLOTS16.EXE.  For example, if you are running
  89. a Spitfire BBS, you would edit SF.BAT to look similar to the following:
  90.  
  91. :DOOR_A
  92.    REM Place Door A Commands Here
  93.    CD\SF\DOORS\SLOTS   <-- Change to the Jackpot Slots directory
  94.    SLOTS16 GAME.CFG    <-- The main program with configuration file argument
  95.    CD\SF               <-- Change back to the Spitfire directory
  96.    GOTO LOOP
  97.  
  98. NON-STANDARD PORT USE:  You may specify the use of non-standard communications
  99. ports with the PORT command.  The syntax for the PORT command is PORT:03E8:5,
  100. where 03E8 represents a different base address and 5 indicates the IRQ.  For
  101. example, the main program line in the example above would be changed to
  102. SLOTS16 GAME.CFG PORT:03E8:5 to reflect the use of a non-standard comm port.
  103.  
  104. FOSSIL DRIVER USE:  You may specify the use of a FOSSIL driver with the PORT
  105. command added to the main program command line.  The syntax for the PORT
  106. command is PORT:F:P, where F instructs the door to use a FOSSIL driver and P
  107. identifies the port.  For example, the main program line in the example above
  108. would be changed to SLOTS16 GAME.CFG PORT:F:1 if the SysOp wished to specify
  109. a FOSSIL driver on port 1.
  110.  
  111. NOTE:  The PORT command must be the third command in the main program command
  112. line, if used.  If not used, the door defaults to the use of the 4 standard
  113. communications ports (1-4) by reading the BBS file.
  114.  
  115. CONFIGURATION FILE
  116. ~~~~~~~~~~~~~~~~~~
  117. Entries in the GAME.CFG file must be accurate or the door cannot be expected
  118. to function properly.  Save your changes to the GAME.CFG file in ASCII text
  119. format.
  120.  
  121. The GAME.CFG file
  122. ~~~~~~~~~~~~~~~~~
  123. Jackpot Slots               <-- Line 1  (See below)
  124. c:\sf\door.sys              <-- Line 2    "     "
  125. The Gamekeeper's Lair       <-- Line 3    "     "
  126. Steve Sharpe                <-- Line 4    "     "
  127. 000000000000                <-- Line 5    "     "
  128. 1                           <-- Line 6    "     "
  129.  
  130. Line 1 - This line reflects the name of the door.  The registration algorithm
  131. is based on some of this data.  DO NOT CHANGE LINE 1!
  132.  
  133. Line 2 - Enter the full path and filename for the BBS DOOR.SYS file.
  134.  
  135. Line 3 - Enter the name of your BBS.
  136.  
  137. Line 4 - Enter the SysOp's name.
  138.  
  139. Line 5 - Enter 12 zeros if the door is not registered.  Registered users enter
  140. the registration number provided by the author.  Other numbers will prevent
  141. the door from running.
  142.  
  143. Line 6 - Enter 1 if your BBS DOOR.SYS drop file is the original GAP standard
  144. 31 line version.  Enter 2 if your BBS DOOR.SYS drop file is the newer (longer)
  145. version (presently 52 lines).
  146.  
  147. SYSOP KEYS
  148. ~~~~~~~~~~
  149. The following keys assist the SysOp in the management of the door:
  150.  
  151.          F5 - Shell to DOS
  152.          F8 - Return user to system
  153.          F9 - Toggle display on/off
  154.         F10 - Chat mode (ESC to exit)
  155.       ALT H - Toggle between status lines
  156.  
  157. REGISTRATION
  158. ~~~~~~~~~~~~
  159. The registration fee for Jackpot Slots is $10.  The unregistered door displays
  160. "EVALUATION COPY" upon entry and exit.  Please register or remove the door
  161. within 90 days of first use.  As a BBS SysOp, I understand how costly it can
  162. be to register BBS software.  I have purposely kept the cost of registering
  163. Jackpot Slots to a minimum with that thought in mind.  I believe the fee is
  164. quite reasonable, based on the many long hours of programming required.  Upon
  165. receipt of the registration fee, you will be provided with a unique
  166. registration number.  Once you insert the registration number into the GAME.CFG
  167. file, the opening and closing "EVALUATION COPY" messages will be replaced with
  168. the following messages:
  169.  
  170. [OPENING MESSAGE]
  171.  
  172.                                 Your BBS name
  173.  
  174.                                   presents
  175.  
  176. [CLOSING MESSAGE]
  177.  
  178.                              Thanks for playing
  179.  
  180.                                Jackpot Slots
  181.  
  182.                                      on
  183.  
  184.                                Your BBS name
  185.  
  186. COMMENTS/BUG REPORTS
  187. ~~~~~~~~~~~~~~~~~~~~
  188. I'm interested in all user comments and bug reports.  Please send your comments
  189. to:
  190.  
  191.                               Steve Sharpe
  192.                            1835 Stonetree Dr.
  193.                          Mountain Home, ID 83647
  194.  
  195.                                  Warranty
  196.                                ------------
  197.        This program has been thoroughly tested on a Spitfire 3.2 BBS,
  198.        however, it should perform equally well on any BBS that can
  199.        produce a BBS drop file listed in this documentation.
  200.  
  201.        I make no warranty of any kind, express or implied, including
  202.        without limitation, any warranties of merchantability and/or
  203.        fitness for a particular purpose.  I shall not be held liable for
  204.        any  damages, whether direct, indirect, special or consequential
  205.        arising from a failure  of this program to operate in the manner
  206.        desired by the user.  I shall not be held liable for any damage to
  207.        data or property which may be caused directly or indirectly by the
  208.        use of this program.
  209.  
  210.        In no event will I be held liable for any damages, including (but
  211.        not limited to) any lost profits, lost savings or other incidental
  212.        or consequential damages arising out of the use or inability to
  213.        use this program, or for any claim by any other party.
  214.  
  215.        This warranty is governed by the laws of the State of Idaho.
  216.                               REGISTRATION FORM
  217.                               -----------------
  218.  
  219.   Jackpot Slots                    Return to:  Steve Sharpe
  220.   Version 1.6                                  Attn: Door Registration
  221.   Registration Cost: $10                       1835 Stonetree Dr.
  222.                                                Mountain Home, ID 83647
  223.  
  224.   Name ______________________________________________________________
  225.  
  226.   Address ___________________________________________________________
  227.  
  228.           ___________________________________________________________
  229.  
  230.   Voice Phone _____________________ Data Phone ______________________
  231.  
  232.   Enter GAME.CFG file information below:
  233.  
  234.   BBS Name______________________________________________
  235.  
  236.   SysOp Name____________________________________________
  237.  
  238.   Orders outside the USA add $2.00 . . . . . . . . . . . . _________
  239.  
  240.       Please find enclosed a check or money order for USA $_________
  241.   payable to Steve Sharpe.  This shows my support of Shareware products
  242.   and the Shareware concept.  It also shows my encouragement to help further
  243.   the development of BBS doors.
  244.  
  245.       I understand that Jackpot Slots is provided as-is and no warranties of
  246.   any kind, expressed or otherwise, are included and that I am using it at my
  247.   own risk.
  248.  
  249.   Signed: _________________________________________  Date: _________
  250.